home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 47.7z / BS1 part 47 / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf / apa.lzh.parta / mb_hlp < prev    next >
Text File  |  1994-04-21  |  13KB  |  347 lines

  1. \ApAssist
  2. \: - This is the Quick Help for the buffer panel -
  3. \: ----------------------------------------------------------
  4. \:   Written by David E. Patterson
  5. \: ----------------------------------------------------------
  6.  
  7. \font topaz.font 8
  8. \tc 1
  9. \wr
  10. \lj
  11. \dd "imh_descriptor"
  12.  
  13. \index "hlp_index/index"
  14. \toc "imh_toc/toc"
  15. \help "aa_help/help
  16.  
  17. \node "mb_killprimary"
  18. \title "Kill Primary Buffer"
  19. \next "mb_killother"
  20. \prev ""
  21. This \{ \ts b \ts b will KILL \} the primary buffer.  If you have not saved
  22. your work, it \{ \ts i will be lost\} .
  23.  
  24. Once you have deleted the current primary, \{ \ts b Imagemaster R/t \} will
  25. allow you to choose another primary buffer - if you had more than one buffer
  26. loaded.
  27.  
  28. If you have no other buffers loaded, a selection menu will not be provided.
  29.  
  30. User Interface: \{ \nw \ts b Buffers panel
  31.                    Kill Primary Buffer\}
  32.  
  33. \endnode
  34.  
  35. \node "mb_killother"
  36. \title "Kill other Buffer"
  37. \next "mb_newbuffer"
  38. \prev "mb_killprimary"
  39. Using this will give you the option to KILL any buffer, except the primary.
  40. Remember that if you have not saved, any changes \{ \ts i will be lost\} .
  41.  
  42. See Also: \{ \nw \ts b \link "ARexx Command Equivalent" "imdoc:hlp_arexx8/killbuff"\}
  43.  
  44. User Interface: \{ \nw \ts b Buffers panel
  45.                    Kill other Buffer\}
  46.  
  47. \endnode
  48.  
  49. \node "mb_newbuffer"
  50. \title "New Buffer"
  51. \next "mb_selprimary"
  52. \prev "mb_killother"
  53. The New Buffer panel gives you the oportunity to create a new buffer.
  54.  
  55. The new buffer can either be created empty (black, or set to a custom color)
  56. at a custom size, or it can be automatically filled with grey level
  57. information generated by the blend (alpha channel) functions.
  58.  
  59. User Interface: \{ \nw \ts b Buffers panel
  60.                    New Buffer\}
  61.  
  62. \endnode
  63.  
  64. \node "mb_selprimary"
  65. \title "Select Primary Buffer"
  66. \next "mb_selsecondary"
  67. \prev "mb_newbuffer"
  68. This allows you to choose the primary buffer from the current buffers that
  69. are loaded into memory within \{ \ts b Imagemaster R/t\} .
  70.  
  71. Depending on the setting of the \ts bi Graphic Buffer List \ts n control in
  72. the \ts bi SetUp \ts n panel, you will either be presented with a scrolling
  73. list of named buffers, or a page of images and names.
  74.  
  75. Either way, click on the buffer that you want to become the primary buffer.
  76.  
  77. User Interface: \{ \nw \ts b Buffers panel
  78.                    Select Primary Buffer\}
  79.  
  80. \endnode
  81.  
  82. \node "mb_selsecondary"
  83. \title "Select Secondary Buffer"
  84. \next "mb_selblendctrl"
  85. \prev "mb_selprimary"
  86. This allows you to choose the secondary buffer from the currently loaded
  87. buffers.  The secondary buffer is necessary for all operations in the
  88. \{ \ts ib Compose \} panel.
  89.  
  90. Depending on the setting of the \ts bi Graphic Buffer List \ts n control in
  91. the \ts bi SetUp \ts n panel, you will either be presented with a scrolling
  92. list of named buffers, or a page of images and names.
  93.  
  94. Either way, click on the buffer that you want to become the primary buffer.
  95.  
  96. User Interface: \{ \nw \ts b Buffers panel
  97.                    Select Secondary Buffer\}
  98.  
  99. \endnode
  100.  
  101. \node "mb_selblendctrl"
  102. \title "Select Blend Control Buffer"
  103. \next "mb_useundo"
  104. \prev "mb_selsecondary"
  105. This allows you to select a buffer as a blend control.  The blend buffer can
  106. be any buffer that is currently loaded.
  107.  
  108. Depending on the setting of the \ts bi Graphic Buffer List \ts n control in
  109. the \ts bi SetUp \ts n panel, you will either be presented with a scrolling
  110. list of named buffers, or a page of images and names.
  111.  
  112. Either way, click on the buffer that you want to become the primary buffer.
  113.  
  114. User Interface: \{ \nw \ts b Buffers panel
  115.                    Select Blend Control Buffer\}
  116.  
  117. \endnode
  118.  
  119. \node "mb_useundo"
  120. \title "Use Undo Buffer"
  121. \next "mb_renamebuffer"
  122. \prev "mb_selblendctrl"
  123. The undo buffer is an extremely important feature in \{ \ts b Imagemaster
  124. R/t\} .  It is important to note that an undo buffer for a 24 bit RGB image
  125. will require as much memory as the original image, unless the original image
  126. also has a mask (masks are not maintained in the undo buffer).  If the \ts bi
  127. Use Undo \ts n control is selected \{ \ts b Imagemaster R/t \} will always
  128. try to use the undo buffer.
  129.  
  130. It is also important to note that a number of processes require the use of
  131. the undo buffer.  This is because the undo buffer is used as a reference for
  132. the process which is taking place in the primary image.  If an operation
  133. requires an undo buffer \{ \ts b Imagemaster R/t \} will tell you if an undo
  134. buffer has not been allocated.
  135.  
  136. Memory constraints are a concern for most users, and this situation is even
  137. further complicated by the use of an undo buffer.  As previously stated the
  138. undo buffer will use the same amount of memory as the primary image.  A
  139. solution to this "memory shortage" is to clip out the region you are working
  140. on.  After clipping out the area you wish to work on, click on the undo
  141. buffer.  Since this is a much smaller image than the original the memory
  142. requirements are much less.  You can then use the \{ \ts b \ts i Restore to
  143. Src Buffer \} button to replace the altered clip back to the original image.
  144. By doing this you have avoided using the large amounts of memory that the
  145. entire primary image would have required.
  146.  
  147. User Interface: \{ \nw \ts b Buffers panel
  148.                    Use Undo Buffer\}
  149.  
  150. See Also: \{ \nw \ts b \link "Restore to Source Buffer" "mb_restoretosrc" 
  151.           \link "  More on Memory Usage  " "imdoc:imh_ubuffers/ubuffers.more"\}
  152.  
  153. \endnode
  154.  
  155. \node "mb_renamebuffer"
  156. \title "Rename Buffer"
  157. \next "mb_restoretosrc"
  158. \prev "mb_useundo"
  159. This operartion will allow you to rename any active image buffer, excluding
  160. the \{ \ts b \ts i Undo Buffer\} .  Buffers may have the same name, but it
  161. is not wise to do this.  \{ \ts b Imagmaster R/t \} will not confuse two
  162. buffers with the same name, but you might!
  163.  
  164. Depending on the setting of the \ts bi Graphic Buffer List \ts n control in
  165. the \ts bi SetUp \ts n panel, you will either be presented with a scrolling
  166. list of named buffers, or a page of images and names.
  167.  
  168. Either way, click on the buffer that you want to become the primary buffer.
  169.  
  170. See Also: \{ \nw \ts b \link "ARexx Command Equivalent" "imdoc:hlp_arexx10/rename"\}
  171.  
  172. User Interface: \{ \nw \ts b Buffers panel
  173.                    Rename Buffer\}
  174.  
  175. \endnode
  176.  
  177. \node "mb_restoretosrc"
  178. \title "Restore to Source Buffer"
  179. \next "mb_swapcurrent&sec"
  180. \prev "mb_renamebuffer"
  181. This allows you to replace a clipped out region exactly back to the area it
  182. was clipped from in the primary image.
  183.  
  184. There is one restriction, the image that you will be clipping back to must
  185. remain in active memory.  A reloaded image \{ \ts i will not work\} .
  186.  
  187. This operation is the key to working on portions of your images with a level
  188. of isolation (safety) that is very useful. Since this allows you to place a
  189. clipped region back into the image it was clipped from \ts i exactly\ts n ,
  190. you can easily perform the following steps:
  191.  
  192. \{ \nw
  193. \ts b ( 1) \ts n Clip a subregion, such as a face from a body as the new primary
  194. \ts b ( 2) \ts n Process that region to your heart's content
  195. \ts b (3a) \ts n Either discard it and make the original primary (lose changes)...
  196. \ts b (3b) \ts n ...or restore it, changing the original image.\}
  197.  
  198. This type of operation is an excellent way to work on small areas of an
  199. image. If you are short on memory, it can also allow you to use the undo
  200. buffer in situations that would otherwise be impossible. Since a clipped
  201. region takes so much less memory than a complete buffer, even the demands of
  202. both the new clip \ts i and \ts n the memory for an undo buffer that matches
  203. it's size are much, much less than that of an undo buffer for the entire
  204. original image.
  205.  
  206. Because of this, you can turn the undo buffer on when you're working on the
  207. clip and have the convenience of being able to eliminate the most recent step
  208. of your work.
  209.  
  210. See Also: \{ \nw \ts b\link "More on Memory Usage" "imdoc:imh_ubuffers/ubuffers.more"
  211.           \link " Using Undo Buffers " "mb_useundo"\}
  212.  
  213. User Interface: \{ \nw \ts b Buffers panel
  214.                    Restore to Source Buffer\}
  215.  
  216. \endnode
  217.  
  218. \node "mb_swapcurrent&sec"
  219. \title "Swap Current and Secondary"
  220. \next "mb_swapcurrent&blend"
  221. \prev "mb_restoretosrc"
  222. This button will swap the primary and secondary buffers.  This button will be
  223. ghosted if a primary and secondary buffers are not specified.
  224.  
  225. Pressing the \ts bi S \ts n key will also execute this operation.
  226.  
  227. User Interface: \{ \nw \ts b Buffers panel
  228.                    Swap Current and Secondary\}
  229.  
  230. \endnode
  231.  
  232. \node "mb_swapcurrent&blend"
  233. \title "Swap Current and Blend Control"
  234. \next "mb_unlockbuffer"
  235. \prev "mb_swapcurrent&sec"
  236. This allows you to quickly get to the blend control buffer, provided one has
  237. been selected, and work on it.  Since this is a swap, it is simple to return
  238. to the original buffer by pressing this button again.
  239.  
  240. User Interface: \{ \nw \ts b Buffers panel
  241.                    Swap Current and Blend Control\}
  242.  
  243. \endnode
  244.  
  245. \node "mb_unlockbuffer"
  246. \title "Unlock a Buffer"
  247. \next "mb_setaspectdpi"
  248. \prev "mb_swapcurrent&sec"
  249. Unlocking buffers is a way for a user to unlock a buffer which may have been
  250. locked by a PI module or other external application which has been sharing
  251. buffer memory with \{ \ts b Imagemaster R/t\} .
  252.  
  253. This is rarely required, and in most cases, the normal user will not need it.
  254. However, when you are developing PI Modules, it can be very useful.
  255.  
  256. Unlocking a buffer has its consequences.  If the buffer is still being
  257. accessed by an external process and you unlock it, the buffer can be
  258. manually deleted, or the user may even exit and delete all buffers.
  259.  
  260. After all of this, the task which was writing to the buffer will now be
  261. writing to what the system has listed as free memory.  This button will warn
  262. the user that manual unlocking is \{ \ts i not \} normally advised.
  263.  
  264. See Also: \{ \nw \ts b \link "ARexx Command Equivalent" "imdoc:hlp_arexx11/unlockimage"\}
  265.  
  266. User Interface: \{ \nw \ts b Buffers panel
  267.                    Unlock a Buffer\}
  268.  
  269. \endnode
  270.  
  271. \node "mb_setaspectdpi"
  272. \title "Set Current Aspect and DPI"
  273. \next "mb_cat"
  274. \prev "mb_unlockbuffer"
  275. This button allows you to customize each image to your display, and to change
  276. the aspect ratio.  If you save your image after changing its aspect it will
  277. retain that aspect the next time it is loaded, not the original aspect.
  278.  
  279. \{ \ts b \tc DarkBlue How To determine Aspect Ratios\}
  280.  
  281. \{ \ra \image "Clips/Bullet2.pic" l 10 \cap 
  282. First, the size of the desired output area (screen, output paper, etc) must
  283. be measured for length and height.\}
  284.  
  285. \{ \ra \image "Clips/Bullet2.pic" l 10 \cap 
  286. Next, the pixel width is determined by dividing the width of the output
  287. device by the number of pixels.  For example, 320 pixels is aproximatly 10.5
  288. inches on our 1084 monitor.  The pixel width would be: (10.5/320) = .033
  289. inches/pixel horizontally.\}
  290.  
  291. \{ \ra \image "Clips/Bullet2.pic" l 10 \cap 
  292. The same process would be used to determine the height.  For example, we
  293. found that in non-interlace mode the displayed region was 8 inches.  The
  294. pixel height would be: (8.0)/200) = .04 inches vertically. \} 
  295.  
  296. \{ \ra \image "Clips/Bullet2.pic" l 10 \cap 
  297. The aspect ratio can now be calculated.  For example, using the previous
  298. values: (.033/.04)100 = 83%.  This process can be repeated for any number of
  299. resolutions.\}
  300.  
  301. See Also: \{ \nw \ts b \link "ARexx Command Equivalent" "imdoc:hlp_arexx4/aspect"\}
  302.  
  303. User Interface: \{ \nw \ts b Buffers panel
  304.                    Set Current Aspect and DPI\}
  305.  
  306. \endnode
  307.  
  308. \node "mb_cat"
  309. \title "Add Image to Catalog"
  310. \next "mb_edit"
  311. \prev "mb_setaspectdpi"
  312. This selection will add the current primary buffer to the catalog.  You will
  313. only need to use this function if you have the \{ \ts bi Auto Catalog \}
  314. button, in the \{ \ts bi Setup \} panel, turned off.  If Auto Catalog is
  315. selected, all images that are loaded will automatically be added to the
  316. current catalog.  
  317.  
  318. User Interface: \{ \nw \ts b Buffers panel
  319.                    Add to Catalog\}
  320.  
  321. \endnode
  322.  
  323. \node "mb_edit"
  324. \title "Edit Image Annotation"
  325. \next ""
  326. \prev "mb_cat"
  327. This selection allows you to edit any text notes that have been saved with an
  328. image.  Imagemaster has two formats which support annotation - IFF and TRIM.
  329. The annotation will only be saved with the image if one of these two formats
  330. is the selected \{ \ts b Save Type\} . Pressing this button will bring the
  331. Amiga text editor \{ \ts b ED \} to the front.  If the current primary image
  332. has any associated annotation it will automatically appear in the editor.
  333. You can then enter the desired annotation to be saved with the image file.
  334. After you have finished your annotation, press the escape key and then the
  335. \{ \ts b s \} and \{ \ts b a \} keys, followed by the Return key.  This will
  336. save the annotation to a temporary file in ram.  You can exit ED by pressing
  337. escape, q, and then Return keys.  The annotation file will be saved to the
  338. image file when the image is saved.  If you do not save the image before
  339. exiting R/t, the annotation will be lost.
  340.  
  341. User Interface: \{ \nw \ts b Buffers panel
  342.                    Edit Image Annotation\}
  343.  
  344. \endnode
  345.  
  346.  
  347.